blog[js]: Add post announcing JS SDK 2.0 #6574

JamieDanielson · 2025-03-19T18:48:02Z

OpenTelemetry JavaScript recently released SDK 2.0. There have been many improvements and breaking changes and we want to make this easily findable.

maryliag · 2025-03-19T19:07:05Z

content/en/blog/2025/otel-js-sdk-2-0.md

+  [v2.0.0](https://github.com/open-telemetry/opentelemetry-js/releases/tag/v2.0.0)
+  and
+  [v0.200.0](https://github.com/open-telemetry/opentelemetry-js/releases/tag/experimental%2Fv0.200.0)
+  releases and provide feedback


do you want to add something on how to provide feedback? I see people getting confused on how to do so. Maybe mention creation of issues, or reaching our slack/SIG. I know you added slack and sig right below, but wanted to make more clear those are the communications channels for feedback too

The upgrade guide has this blurb, FWIW:

If you have any questions about the 2.x changes, please ask! You can reach the OTel JS community on the [#otel-js](https://cloud-native.slack.com/archives/C01NL1GRPQR) channel of the [CNCF Slack](https://slack.cncf.io/), [open a Discussion issue](https://github.com/open-telemetry/opentelemetry-js/issues/new?template=discussion.md) on the repository, or join the weekly [OTel JS SIG zoom call](https://docs.google.com/document/d/1tCyoQK49WVcE-x8oryZOTTToFm7sIeUhxFPm9g-qL1k/edit).

If you have any questions about the 2.x changes, please ask! You can reach the OTel JS community on the #otel-js channel of the CNCF Slack, open a Discussion issue on the repository, or join the weekly OTel JS SIG zoom call.

Oh... I guess the subsequent few bullets include links on how to get involved.

trentm

Nice. LGTM.

content/en/blog/2025/otel-js-sdk-2-0.md

chalin · 2025-03-20T09:48:35Z

content/en/blog/2025/otel-js-sdk-2-0.md

+---
+title: Announcing the OpenTelemetry JavaScript SDK 2.0
+linkTitle: OTel JS SDK 2.0
+date: 2025-02-21


Suggested change

date: 2025-02-21

date: 2025-02-20

content/en/blog/2025/otel-js-sdk-2-0.md

chalin

Great to see a blog post about the new release. See inline comments for preliminary suggestions.

chalin · 2025-03-20T09:55:57Z

content/en/blog/2025/otel-js-sdk-2-0.md

+cSpell:ignore: Danielson
+---
+
+Exciting news!


Suggested change

Exciting news!

Exciting news:

chalin · 2025-03-20T09:56:42Z

content/en/blog/2025/otel-js-sdk-2-0.md

+---
+
+Exciting news!
+[OpenTelemetry JavaScript](https://github.com/open-telemetry/opentelemetry-js)


Suggested change

[OpenTelemetry JavaScript](https://github.com/open-telemetry/opentelemetry-js)

[OpenTelemetry JavaScript](/docs/languages/js/)

chalin · 2025-03-20T09:57:21Z

content/en/blog/2025/otel-js-sdk-2-0.md

+Exciting news!
+[OpenTelemetry JavaScript](https://github.com/open-telemetry/opentelemetry-js)
+has released
+[SDK 2.0](https://github.com/open-telemetry/opentelemetry-js/releases)!


Suggested change

[SDK 2.0](https://github.com/open-telemetry/opentelemetry-js/releases)!

[SDK 2.0](https://github.com/open-telemetry/opentelemetry-js/releases/tag/v2.0.0)!

chalin · 2025-03-20T10:03:54Z

content/en/blog/2025/otel-js-sdk-2-0.md

+There is a
+[migration guide](https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md)
+in the repository detailing breaking changes and steps for users to take to
+upgrade to the latest versions.


This paragraph seems redundant given the content below. If you intended this to be a TL;DR or call out, then wrap it in an alert like this:

Suggested change

There is a

[migration guide](https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md)

in the repository detailing breaking changes and steps for users to take to

upgrade to the latest versions.

{{% alert-md title="Migration guide" color="info" %}}

For a detailed description of breaking changes, see the **migration guide**

[Upgrade to OpenTelemetry JS SDK 2.x][migration guide].

[migration guide]:

https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md

{{% /alert-md %}}

chalin · 2025-03-20T10:04:31Z

content/en/blog/2025/otel-js-sdk-2-0.md

+
+## What is JS SDK 2.x?
+
+"JS SDK 2.x" encompasses new releases of the `@opentelemetry/*` JavaScript


Why the quotes? I suggest dropping them:

Suggested change

"JS SDK 2.x" encompasses new releases of the `@opentelemetry/*` JavaScript

JS SDK 2.x encompasses new releases of the `@opentelemetry/*` JavaScript

chalin · 2025-03-20T10:08:10Z

content/en/blog/2025/otel-js-sdk-2-0.md

+except the API and semantic-conventions packages. The package versions for this
+new major will be `>=2.0.0` for the stable and `>=0.200.0` for the unstable
+packages. Details on the full list of packages can be found in the
+[migration guide](https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#what-is-js-sdk-2x).


If you commit the {{% alert-md ... %}} suggested previously, you'll be able to reuse the markdown link definition:

Suggested change

[migration guide](https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#what-is-js-sdk-2x).

[migration guide][].

chalin · 2025-03-20T10:10:29Z

/fix:refcache

opentelemetrybot · 2025-03-20T10:10:51Z

You triggered fix:refcache action run at https://github.com/open-telemetry/opentelemetry.io/actions/runs/13966803156

opentelemetrybot · 2025-03-20T10:16:26Z

fix:refcache was successful.

IMPORTANT: (RE-)RUN `/fix:all` to ensure that there are no remaining check issues.

chalin · 2025-03-20T10:18:33Z

FYI, related concern:

Publish "Upgrade to OpenTelemetry JS SDK 2.x" to the OTel website #6579

opentelemetrybot requested a review from a team March 19, 2025 18:48

github-actions bot added the blog label Mar 19, 2025

JamieDanielson requested review from a team and maryliag and removed request for a team March 19, 2025 18:48

opentelemetrybot requested a review from a team March 19, 2025 18:52

maryliag reviewed Mar 19, 2025

View reviewed changes

trentm approved these changes Mar 19, 2025

View reviewed changes

chalin reviewed Mar 20, 2025

View reviewed changes

content/en/blog/2025/otel-js-sdk-2-0.md Outdated Show resolved Hide resolved

opentelemetrybot requested a review from a team March 20, 2025 09:47

chalin reviewed Mar 20, 2025

View reviewed changes

opentelemetrybot requested a review from a team March 20, 2025 09:52

chalin reviewed Mar 20, 2025

View reviewed changes

chalin mentioned this pull request Mar 20, 2025

Publish "Upgrade to OpenTelemetry JS SDK 2.x" to the OTel website #6579

Open

chalin mentioned this pull request Mar 20, 2025

Add nudge to PR actions #6578

Open

JamieDanielson and others added 7 commits March 20, 2025 06:47

blog[js]: Add post announcing JS SDK 2.0

c95d50d

fixins

573545f

ignore me

6bda178

another fix it seems

b0cd656

Set draft status

d6e2d24

Fix date

db8b39f

Results from /fix:refcache

d0359b8

chalin force-pushed the jamie.blog-oteljs-sdk-2-0 branch from 9d7e359 to d0359b8 Compare March 20, 2025 10:47

opentelemetrybot requested a review from a team March 20, 2025 10:47

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

blog[js]: Add post announcing JS SDK 2.0 #6574

blog[js]: Add post announcing JS SDK 2.0 #6574

JamieDanielson commented Mar 19, 2025

maryliag Mar 19, 2025

trentm Mar 19, 2025 •

edited

Loading

trentm Mar 19, 2025

trentm left a comment

chalin Mar 20, 2025

chalin left a comment

chalin Mar 20, 2025

chalin Mar 20, 2025

chalin Mar 20, 2025

chalin Mar 20, 2025

chalin Mar 20, 2025

chalin Mar 20, 2025

chalin commented Mar 20, 2025

opentelemetrybot commented Mar 20, 2025

opentelemetrybot commented Mar 20, 2025

chalin commented Mar 20, 2025

	[OpenTelemetry JavaScript](https://github.com/open-telemetry/opentelemetry-js)
	[OpenTelemetry JavaScript](/docs/languages/js/)

	[SDK 2.0](https://github.com/open-telemetry/opentelemetry-js/releases)!
	[SDK 2.0](https://github.com/open-telemetry/opentelemetry-js/releases/tag/v2.0.0)!


		## What is JS SDK 2.x?

		"JS SDK 2.x" encompasses new releases of the `@opentelemetry/*` JavaScript

	"JS SDK 2.x" encompasses new releases of the `@opentelemetry/*` JavaScript
	JS SDK 2.x encompasses new releases of the `@opentelemetry/*` JavaScript

	[migration guide](https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#what-is-js-sdk-2x).
	[migration guide][].

blog[js]: Add post announcing JS SDK 2.0 #6574

Are you sure you want to change the base?

blog[js]: Add post announcing JS SDK 2.0 #6574

Conversation

JamieDanielson commented Mar 19, 2025

Choose a reason for hiding this comment

trentm Mar 19, 2025 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

trentm left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

chalin left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

chalin commented Mar 20, 2025

opentelemetrybot commented Mar 20, 2025

opentelemetrybot commented Mar 20, 2025

IMPORTANT: (RE-)RUN /fix:all to ensure that there are no remaining check issues.

chalin commented Mar 20, 2025

trentm Mar 19, 2025 •

edited

Loading

IMPORTANT: (RE-)RUN `/fix:all` to ensure that there are no remaining check issues.